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EDITORIAL ? 


The slave hits the Keyboard again. Nothing happens. Drop Envelope. 
In Envelope: There is a note lying on the ground. Take mote. Read 
Note: ‘You can find cut about discs this month and tapes next month, 
Happy adventuring.’ reads the note. 


By now you have some idea of the present issue, and things to come. 
(Like Christmas Carols?) 


MAGAZINE NAME: 
After passing all your suggestions round the committee, two rounds of 
voting were held on them. The final winner was Sam’s, ‘BEEBLET’ (p.23 
Sept). We will start using this at the start of Vol.2, in February; 
$0 you all have a couple of months to send in designs based on it, or 
register any most strenuous obJections. 


BEE BUG: 
After the 31st November, we will NO LONGER accept subscriptions to 
BEEBUG, until the next financial year and renewal time. So if you 
wish to get BEEBUG through us, get your cheque to us FAST. 
LOCAL GROUPS: 
TAUPO: 


Taupo is setting wp a local group; contact David ph.f4-215 for 
details. 


HAWKES BAY: 
HawkesBeeb intends meetings probably alternating each month between 
Hastings Boys’ High School, and somewhere in Napier, Contacts: 
Kendall Napier 435-624 e 
oS Bob Taradale 446-955 ih 
Mitch Hastings 778-235 
Next meeting Tuesday {3th February at Colenso H.S. Napier, probably 
This has yet to be finalised. 
What deo you think of Hawksby, their logo? A cross between a hawk and 
Magpie they say. 


AUCKLAND: 
December meeting usual date & times, talk on Torch and CP/M. 


WELLINGTON: 
conta with Wellington Micro Soc, on ### Thursday & December, *## 
Further details announced at November meeting, else phane contacts on 
Back page. 

NEXT MONTH: 
All sorts of interesting bits and pieces, some of which YOU haven’t 
sent in yet!!! The slave-driver cracks the whip. 


3 
TESTING UPPER / LOWER CASE 


Although the code to allow both upper and lower case entries from the 
Keyboard, and treat them the same has been used a few times in the 
magazine {eg ‘Drunk’ line 2638, Jan issue), it has never been 
explicitly mentioned. Thanks to Brian of Ashburton for bringing it to 
our attention. 

How often are you bothered by a program that insists you enter a 
capital ’Y’, and promptly exits if you type in a jower case ’y’, This 
code accepts lower case AND upper case, and considers them the same. 


If you wish to understand the code, you will need to consider the 
ASCII characters, and how they are stored in the computer. Hach 
character is stored in a Separate byte, and has a characteristic bit 
pattern. When these are examined, there is an obvious and simple 
difference between the upper case bit patterns, and those for lower 


Case: 

UPPER CASE: LOWER CASE 
CHR HEX BINARY CHR HEX BINARY 
A &41 6108 BGG! a &ét 9118 Bob1 
B &42 8108 8018 b £62 6116 8016 
C &43 8106 GO13 ¢ &62 8118 BAL! 
2 &5A G11 1618 z &7A Gilt 1816 


You will notice that the only difference is that the third bit from 
the left is @ for upper case, and 1 for lower case. So all that has 
to be done is to force this bit ta become 9. How? We can either use 
the fact that you can describe the ASCII codes for upper case as being 
&2@ less than lower case equivalents, or we can use the logical 
operator ‘AND’ with a suitable value whichis &DF, or i1¢4 ifit 
binary), (See User Guide 9.205), The iatter is the ‘more 
sophisticated’ method, but both will work, 


SOME EXAMPLES IN CODE: 

1@ REPEAT 

28 AX=GET 

38 PRINT CHR#(A%) 

46 BY=Ax-&26 tREM aor BH=AY AND &DF 

5B PRINT CHRS(BY) 

66 UNTIL FALSE ~ 

That will print all lower case input as voper case. In most 
applications, the GET and conversion will be done in the same line: 
1@ REPEAT 

20 B4=GET AND &DF 

3@ PRINT CHRE(BY) 

4@ UNTIL FALSE 


4 SPEED TYPISTS 


Tim R. Wainuiomata 
1 was sitting down in front of my Beeb the other day and | realised 
that although I can touch type, my speed is very slow (something like 
15 words per min). To rectify this I decided to write the program 
reproduced below. This is not a typing tutor mind you ~ simply a biank 
Piece of paper to type on. The only thing it does do 1s provide 
automatic new-lines and Keeps a tab on your typing speed. 


$B REM HXKHMEK ERK RHAK AD KATES ERE 
26 REM *% 4% 
38 REM ¥* TYPING PRACTICE ¥# 
48 REM #* BY TIM RYAN tt 


38 REN xt 
GA REM HRNER ERA RAR EARS SESAME EEE 


74 

88 ON ERROR MODE 7:PROCend 

85 words/=e: t imes=B 

9B MODE 3 

188 PROCinstructions 

116 MODE 8 

128 PRINT TAB(18,8) "TYPENG PRACTICE 

198 PRINT TABCEI,1) "WORDS TYPED SO FAR: 8608 7 8008 SECONDS" 
146 YOU 28,8,31,79,3 

158 enckeyst=" 'HOARQ=7T-A\ CES} )arts Cd. 2/8 timez=T IME 
164 still_flaq/=FALSE 

176 REPEAT 

188 = possibleend/=FALSE 

198 AS=GET$:PRINT AS: 

208 =F ASCCAS)=9 THEN PROCpause 

Fif IF ASCCAS)=13 THEN YDU 14 

228 so IF INSTRiencLkeys$,A$)28 OR ASC(A$)=13 THEN possible_end“STRUE 
236 «so IF possible_end/=TRUE AND still_flag“=FALSE THEN PROCword done 
246 IF possible end/=FALSE THEN still_flaq/=FALSE 

25¢ UNTIL FALSE 

268 

276 DEF PROCGword done 

288 words/=wor ds4+ | 

298 IF POS)7@ THEN VDU 13,18 

388 VOU S:HOVE 546,991 

318 VOU 127,127,127,127 

320 PRINT RIGHT$¢" 8B" 4 STR$(words”) , 4): 

338 MOVE 748,994 :VDU 127,127,127, 127 

346 PRINT RIGHT$(* gee" +STRS(CTIME- timed) DIV 168), 4); 
358 VOU 4 

368 still_flaq/=TRUE 

378 ENDPROC 


388 BEF PROCinstructions 
390 PRINT TAB 20,3) "#XeeeRRE RAE ARASH EHR” 


486 PRINT TABC20,4) "## Pre 
4]@ PRINT TAB( 28,5) “x% TYPING PRACTICE ru 
428 PRINT TAB(26,4) "4 BY TIM RYAN axe 
430 PRINT JABC28,7) “xx 4" 


440 PRINT TAB( 20,8) SHHRHBB UBB UB BEBE BEEBE Ga 6/7 

458 PRINT ‘The idea of this program is to allow a person who has mastered thei 
r fingering,® 

464 PRINT "say on a mechanical typewriter, to practise their skills without wa 
sting reams” 

478 PRINT "and reams of typing paper." 

498 PRINT “hen you have had enough, hit the escape Key to see sow weil you ha 
ye done.” ” 

494 PRINT ‘14 you just want to pause temporarily to see how you are doing, hit 
the TAB Key." 

5B6 PRINT “Any Key typed afterwards will get you going again.’ 

S18 PRINT “If you want to type in lower case, make sure the cePS .0CK and SHIF 
T LOCK are’ 

528 PRINT “set correctly now." ’ 

330 PRINT "Simoly press any key to start, then begin typing ..... 

548 AS=GETS 

554 ENDPROC 

544 

374 DEF PROCpause 

588 timezé=TIME 

598 AS=GETSIPRINT A; 

688 timex=timex+TIME-t ime ct 

$18 GHDPROE 

628 DEF PROCend 

438 CN ERROR OFF 

$48 VOU 26 

456 PRINT TABCH! (6) CHRS14i:*TYPING PRACTICE* 

668 PRINT TABC11.11) CHRSES1;"TYPING PRACTICE" 

$78 PRINT TAB{O,15) “You typed an av. of "SINT(wordsd/(TINE~times) #4096) :" wor 
ds per minute™ ‘” 

688 END 


SOME IRRELEVANT ENVELOPES, JUST TO TRY: 


ENVELOPE £4150;050,0,0,0,126,-1,9,-5,126,8 
ENVELOPE 1,433,9:4,0.3)4:1.126,6.0,-10,126,0 
ENVELOPE £53018 1-3016:4:6213,6:0.-126,126 
ENVELOPE 1,129,058,6,26,6,40,0,0,1,126,126 
ENVELOPE 1:4:6.6164295,2951255.426,-1,0,-10,126,50 
ENVELOPE 151:4:74,10,20:16,40,427,0:0,-5,426,126 


& 

ADYVENTURING: 
Most people are very aware of the ‘clobber-betore-you-get-clobbered 
type of arcade game. They require very fast reflexes, and an 
unlimited supply of S@cent coins. An adventure game is more 
leisurely, oemanding less of your quick reflexes than of inventive 
intellect. As with playing chess; you meed to consider possible 
reactions tc your moves before you make them - it’s no fun losing 
something when a bit of forethought would have avoided the loss, or 
foreseen ar answer to a puzzle. Arcade games require colour, and 
lots of it. Adventure games usually don’t. 


Steve (Epsom): To the uninitiated, the appeal of a game consisting of 
a text-onl: dialogue between operator and computer may be difficult to 
understanc. To those (like myself) who have spent literally hunogreds 
of hours trying to solve the puzzles of Colossal Cave (Level ?’s most 
popular aoventure), there is no such difficulty! Am adventure is a 
role playing game (RPG) where the player takes tne role of an 
Adventurer untrepid or otherwise), charged with a task or mission. 
It may involve collection of treasures or artefacts, the solving of 
riddles etc. The computer takes the role of ‘mentor’, describing 
locations. answering questions etc. The player instructs it in 
English wit? brevity eg GET / DROP / HELP LAMP, BOTTLE, TROLL etc. 
I have about 2@ for the BBC ranging from superb (Acornsoft or Level 9) 
to mediocre (Computer Concepts), To anyone wanting an adventure to 
start with, 2 would recommend Sphinx (Acorn) or Colossal Adventure. 


They also have educational value: 

Tony T.’s children don’t Know that abbreviations are permissable, so 
they are learning spelling as well as extending their vocabulary 
through playing ‘Sphinx’ (Acornsoft), Also they learn mapping skills, 
a5 a map is drawn to show where they are or have deen, and 
relationships between places. (Here there be alligators!) 


Judy (Tauranga?’s favourite relaxation was Philosophers Quest. "I say 
‘was’ because after a determined effort and with the help of my 193 
year old son and friend we scored 236 points faut of 250). We are are 
obviously missing one piece of treasure, and countless efforts and 
bright ideas have failed to find it. Can anybody help? One thing we 
did discover was that it is essential to ‘save’ games as we went,’ 


Tony B. who reviewed ‘Colossal Adventure’ in August is busy trying to 
open the giant clam in it. (If he’d been listening to Brian Clarke & 
een ee through October, he would have heard what to do with 
shelifis 


Inventiveness and wit are required for these games, and you can profit 
from mistakes. “For those of you unfamiliar with this type of game, 
some examples from Level ?/s 


ra 


DUNGEON ADVENTURE: 

It’s not what’s there, it's what you’ve got: a doorway which you 
attempt to enter: to be told ‘Only Archers Allowed’. Solution? Become 
an archer: find a bow. Sometimes you are not aware that you have 
passed such a test until you try another day to enter. without some 
item you never figured out a use for. 


In dungeons there is the perennial problem of light, or the lack af 
it. On exnausting my current light-source, I retreated to another 
room that ! Knew would light up, and got this reaction: 

The octoous waves its arms and you can see. Thus "many hands make 
light wore!” 

You cannot see, 

A ghoul emerges from the dark and eats you «. 

The first time, when my light-source was strona; the octopus was 
amusing, Sut this time, ... 5 much for invention. I have since 
’ discovered how to renew my light source. Royden, keep trying - it’s 
possible, 


A game can stretch your imagination, sometimes by alluding to books 
ton: 

"A gigant:¢ orc’s head is carved into the cliff north of the river, 
its tongu2 farming a Oridge aver the waters to you. A ruined tower 
stands on tom of the cliff.’ 

Orcs - Telxien. Ever read The Sword of Shannara? Remember Skull 
Mountain? Later on you may find sticky passages from which you fall 
to the mver below and drown. Sticky? With what?... The wight house 
is a pimple on iis nose. Enougn. 

A game that has much ta recommend it, with an 9-page booxlet from 
Level 9 Computing in the UK isend ‘9.96 te them at 229 Hughenden Rd, 
High Wycombe, Bucks, HP13 5PG, England ~- approx NZé24). 


BOOK: 

‘Creatine ADVENTURE programs on the EBC MICRO’ by fan Watt. ub, 
Interface cublications / Addison Wesley. 

Shows you now to go about creating your. own adventures, but most of it 
deals with the cading, of 3 long programs, The author originally 
wrote these programs for a 2xX&@, and oelieves 16K HAM is almost 
essential, There are sections of code that make obvious mis 
unfamiliarity with BBC BASIC; where he uses very complicated code that 
is not needed by the BEC. Not a PROC in sight either! I gave up. A 
great pity, as he does have some basic ideas on how to develop ‘flat’ 
scenarios, a room numbering system, what various objects could be used 
for, restrictions on them ett, Nevertheless at almost $30.06 for 12% 
pages, | would rather recommend this book to 2X8¢@ users than to BRC 
users. D&D players wouldn‘t get much from it either. Perhaps i’ve 
been spout by games that allow & compass points plus up and downy wa. 


S 

that use 27K RAM for 200+ locations, ... but I expected much more 
from the title than there is; and of higher quality. Spaghetti 
anyone? 


Steve would like to start a BEC Adventure sub-group. Anyone 
interested should write to Steve Williams, 61 Disraeli St, Epsom, 
Auckland 3, 


HALL OF FRAME: 


Send in your High Score from any game for inclusion in this page each 
month. The top 3 scores per game will be published. (Adventure Games 
Stay on until completed!) 


PUBLISHER: GAME HISCORE SCORER 
Acorn Castle of Riddies 2i? K. Family 
Monsters 21,268 Athol 
Phitosophers Guest 236 Judy 
Pianetoid 247,825 Athol 
Snapper 235,266 Susan 
32,448 Sarah (yrs) 
Prog,Pow Killer Gorijla 81,008 Susan 
Level ¥ Colossal Adventure ‘too busy playing to note!’ 
Dungeon Adventure 279 Anne 


$ S ~ eS 
U 4) EE 

16 REM ## Scroll Checker by Tim #%# 

28 

38 OSBYTE<&FFFA:A%=8 

48 DIM CHECK_SCROLL 28 

58 PH=CHECK_SCROLL 

66 [ 

78 DPT 3 we 

BG \ PROGRAM to return value indicating 

a \ hardware op software scrolling 

116 LOA #&75 

126 JSR OSBYTE 

138 TXA 

146 RTS 

158 } 

168 SOF TATUSR( CHECK SCROLL) AND § 

178 PRINT'SCROLL IS'BY: © 

186 IF SOFT THEN PRINT" SOFTWARE" ELSE PRINT" HARDWARE” 

198 END 


Mc GRAPHICS Ill 
TIM R. 


Last time I introduced an ASSEMBLY program that drew a picture on the 
screen using VDU codes. It was a fairly simple program needing some 
redundant information but was intended to show that using OS is as 
fast as your own routines would be (possibly faster, the O5 routines 
have been written by experts for as much speed as possible), The 
whole beauty of these routines is that they are so easy to use. 
Because parameters are usually passed one at a time; the routines 
should work just as fast from the other end of the Tube alse. Fast 
processors working with the Beeb should be able to produce some 
phenomenal results. I really look forward to uses of the Beeb in this 
direction ! (Especially with graphics.) 


I had amother program nearly ready for this issue, using interrupts, 
but in the end I decided to jwice it up a bit for the bumper issue 
next month. Look for it; I think you will find it appealing. I/ve 
been given 2 pretty full listing of the VDU and #FX (i.e. OSBYTE) 
calls and I was Surprised to see that there are a large number of 
undocumented ones, especially OSBYTE calls. There is in fact one for 
nearly all the numbers from @ to 255 in OS t.x. Only thase specified 
as being available for QS @.4 in the User Guide are expected to work 
with an OS 6.1. Am interesting one I noticed was the ability to tell 
whether the CPU was doing a hardware or software scrojl (as I 
discussed last time). To find out which is active type in the program 
belaw (note: this may or may not workin OS @.1), The OSBYTE call is 
&75 and the program should print out hardware if there is mo window 
defined at the moment, and software if you run it after definina a 
"window". 


I quess some of you might be wandering what books would be helpful, 
There ig a review next month in this magazine af two machine code 
books devoted exclusively to the BBC. For general reference I would 
recommend “PROGRAMMING THE 4502’ by Rodnay Zaks. It 1s pretty 
expensive, but something 15 quite necessary if you are going to be 
doing your own experimenting. (Unless of course you have the whole 
language memorised to the last detail), The mnemonics are laid out 
well in Zak’s book with address modes, and other necessary information 
easily readable. [t would be a good idea to read the rest of the book 
too, to gain a full understanding of working of the 6502 CPU, Next 
edit a bit on interrupts; and a rather curious result from a program 
tt ug". 


Listing on left. 


1@ 
DISCS, DRIVES... 


Mel ington"s September meeting: talk by Bryan, notes by 
id. 


INTRODUCTION: 

This was the main topic of the evening: an introduction to discs, what 
they looked like, what you could expect from them; followed by queries 
from the floor. Eryan’s talk was about them in general; without 
specific reference to tne BBC, showing a naked drive (ie out of -its 
case); and illustrating points with diagrams - some of which are 
reproduced here, 


DRIVES: 
The normal drive, in its case, has a front slot for inserting the 
disc, and a lever to close the gate, thus clamping the disc firmly to 
the drive spindle, and the unit to be switched on. Inside the box; 
the main components are: 

{.an array of chips which hold the internal logic of the 
system 

2.a heading head 

g.a motor which rotates the disc at a constant speed (20¢rpm) 

4.a stepper motor to move the reading head to the correct 
point on the disc 

>.connections to the computer and to the disc. 





DISCS: 

A disc is a very thin plastic sheet, encased in a protective cover 
Jey inches square. It has a large central hole through which the 
drive spindle passes. The disc’ contains all its information in a 
series on concentric circles (usually 80), called tracks. It does not 


iid 
have a spiral track like the more familiar gramophone record. 


A part of the disc is exposed by an oblong slot in the outer casing. 
This should NEVER be fingered or otherwise damaged. When the gate is 
closed the reading head is lowered on to the disc at this slot. The 
stepper motor moves the head back and forth along this slot; to reach 
a track wanted on the disc, 


There is also a small circular hole in the cover. When a hole in the 
disc passes this index hole, it aliows a beam of light to pass from 
below up te a photoelectric cell, thus signalling the position of the 

start of each track. 


Tracdex detector Drive 
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Q. Is the disc always spinning? 

Ae Not usually. Most systems have an automatic shut-off to stop 
it when it’s not needed. 

Q. How long does it take to reach full speed? 

A. Generally it is agreed that there is a finite time for it to 
stabilise, say about 2 revs or 350 milliseconds. The head must then 
move across to the right track, settle, then wait until the correct 
part of the track passes underneath it, 


There is alse a notch om the side of the disc cover. When this is 
open, information can be written onto the disc. When it is closed the 
disc is ‘write protected’, and can only be read from. 


DIsC CONTROLLER: 
This is a large ‘smart’ chip inside the computer which controls 
everything between the computer and the disc drive. From the computer 


iz 


it nas links to the data bus, some address anc control lines and a 
clock signal. It has 5 major registers, each of 8 bits, There are 
another 12 special registers, storing essential working information 
et as step timing, head settling time, or allowing a check on drive 
status. 

a. What is a register? 

A. Register is a memory storage location, similar in action to 
the normal memory of the computer. Some registers are read only, some 
write only, and others are read or write as for normal memory. TO the 
dise drive, it controls such actions as select, step forward, write, 
FROM the disc drive it receives signals such as index, 
erate brosegtels track zero etc. It of course relays data to AND from 
he disc. 
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It is very complex, and newer models are constantly being produced, 
The BRC currently uses the 6271 chip. It fits many different 
computers. The controller operates under the direction of a program 
situated inside each computer (the ‘Disc Operating System’), 


DISC SIZE: 

SECTORS: On a disc each track is split into a mumber of equal 
portions called Sectors. These are variable between 1@ and 18 ona 
track, On discs’ formatted by the BBC, each track has 1@ sectors each 
of 254 useable bytes. 

CAPACITY: A disc can have 4@ or 9@ tracks - normally &@ for drives 
sold in NZ - it can have { or 2 sides, and the computer can be linked 
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to one or more drives. Some computers ¢an cope with 
‘double~bit-density’, but the 8271 Disc Controller chip does not allow 
for this. Essentially, on a BBC, a single 48-track, single-sided disc 
holds 40x1@x256 bytes i.e.180K. This can be progressively doubled by: 

doubling the number of tracks (ie to $6) 

doubling the sides 

doubling the drives 
Any combination can be used. Thus a dual drive, with double-sided 
@@-track discs; gives access to 806K bytes of storage. A program can 
talk to both sides of a disc and to discs in both drives of a dual 
system. 


The BBC will support 2 double-sided drives, or 4 single-sided drives. 
But note that more power may be needed for the extra drives involved 
than the BBC’s power supply unit can supply, especially if it is also 
supplying power to other units (eg printer, extra ROMs etc) as well. 


G. Which is better then, to use the Beeb’s power supply, or have 
a PSU with the drive? 
A. Use the BBC’s until you overload it with other units as well! 


Q. Can you turn a single-sided disc over and use the other side? 

Ae All discs are made by the same process. Quality control 
means that those with a probable fault in some way will not earn the 
description ‘double-sided double-density’; and will be sold with a 
lesser label - eg single-sided. As well, the write~protect notch and 
the index detector hole are on the wrong side. There is disagreement 
amongst the experts over the advisability of using a disc beyond its 
stated capabilities. 


Q. What about the new 3" disc drives? 

A There is no industry standard, 2" ones are coming, and maybe 
even smaller anes too. Conclusion: stick with the (relatively) cheap 
and common 5.25" drives for a few years until things settle down, 


Q. Are all disc drives compatible? 

Ae There are 4 basic makes of drive: Olivetti; MPI, Shugart and 
Tandon. The BBC can be connected to any of these. Appropriate 
connections are described in the Disc User Guide, amd are also 
software selectable via the #FX255 call. There are also Mitsubishi 
slimline drives. 


Q. Is there a list of errors you can get using discs? 
A. Yes - in the Disc User Guide. 


Q. How much memory do you lose with discs? 

A. The Disc Operating System requires 3K, and takes this from 
our RAM, starting at PAGE &#@@, ending at &19@8. Most of this is 
uffer space for using files, so if you simply wish to load a program 
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that does mot access files itself, PAGE can be reset from &190@ to 
&1186 before loading in the program trom disc. This reduces the joss 
of computer memory to .75K. It is also possible to load in a program 
then run a routine to shift it down to &E@@ before running the program 
itself. 


a. What is BOOT? 

A. With early computers, the name giver to the machine code 
instructions which had to be given manually im order to gat the 
machine going; was ‘bootstrap’. i.e. the computer had to pull itself 
up by its bootstraps. In the BBC you can set up on dise a ‘file’ 
called 'BOOT which is automatically called after switching on the 
computer when you press SHIFT and BREAK together. This 'BOOT can 
CHAIN in some other program automatically for you (eg a menu, or your 
favourite User Define Keys). 


FIRST IMPRESSI OMS 


WOW! its fast. What a2 saving in coffee too ~ no longer save to 
tape and make coffee while you wait! 


No cassette block @ bug (1.205); the time it took transferring most of 
{38+ tapes to disc! 


Bad Program? it's quicker to reload the original back im than use 
trouble-shooter programs to retrieve part or all of it! 


Menus make sense how, and save a lot of #. and CHAINing. 


Another Usere Guide tao wander through with a whole host of new 
+commands and error messages. 


Ours is set to boot on pressing BREAK, though usual is on SHIFT+BRE AK. 

The problem with ours if the disc in the drive has an active ‘BOOT 
while you develop a program? Pressing BREAK when it is the only way 
to get out of a program means that the menu is CHAINed over it. Fine 
if the problem program was already saved ... 


The ability to Lock files - especially once children have learnt that 
SAVE does something. There are several coptes of programs with 
little-fingered alterations amd peculiar mames. None originally on 
the disc are lost because they are Locked, and can’t be deleted 
be Dave (Ch’ch) points out the quick way to lock everything on a 
isc: 

#A, #.% L (ACCESS). If you are developing a program where all is 
locked, you have then to make a great effort to save a mew version 
with an already-existing name, 


is 
PROC & FN LIBRARY: 


We have tried to build up and publish your PROCs that may be 
transferred between programs. Please send them in. 


Ernian has suggested that we allocate set line numbers to PROCs etc to 
facilitate merging, along the following lines: 
@@0 Mathematical FNs 

{6060 String FNs 

4706@ Graphics FNs 

18000 File handling FNs 

19006 etc... 

20606 DEF PROCs, with similar major subdivisions. 

3000@ machine code or whatever vu 
Makes a change from the Dewey classification! 
1¢ a library of standard FNs, PROCs, subroutines, redefined 
characters, Envelopes, machine code routines, etc were to be built, 
with different line numbers, it would be easy to merge into other 
programs. He also suggests that besides publishing these in tne 
newsletter, a complete booklet and tape or dise ef the current library 
be tor sale to members. 


Another possible way of arranging them could be in alphabetical order 
rather than subJect order. How about more suggestions from you all? 
Brian (Ashburton) is prepared to put some work into this proJect. 


ENTERING LISTINGS: 


4 iot of queries come from members, who have entered a program from 
another magazine, and found that when they try to RUN, nothing 
nacpens. PLEASE refer to our January newsletter p.5, and July p.2c, 
as taking note of ON ERROR will often help. 


Listings for this newsletter are printed out using LISTO? - that is, 
there 15 an extra space put between the line number and the program, 
arn? extra spaces are inserted to show up the REPEAT... UNTIL and FOR 
i NEXT loops, These spaces do NOT have to be typed inf A hone 
looking like: 

1¢ NEXT IS 

srculd be typed in as: 

1ONEXT IX 


QUICK LOWER CASE: 


Brian also says that if you are entering a program with lower case 
variables, you do not have to put the Caps Lock on and off - merely 
hold down SHIFT with Caps Lock ON, and out will come lower case, not 
upoer case!!! 
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ENVELOPES 


Gr parts of them anyway. Anne F. 


The best explanation I’ve come across so far of these commands, comes 
in Jim McGregor & Alan Watt's book ‘The BEC micro book; BASIC, Sound 
and Graphics.’ pub. Addison Wesley N2$29.95. They devote 42 pages to 
music, SOUND and envelopes. This article is thus rendered obsolete 
for the rich (which I’m not). 


It will deal solely with the first 8% parameters of the Envelope 
command, and I recommend having the Users Guide handy (p.i8éff & 
244ff), Also, by entering the program given below, ali the envelopes 
are presented in the order given here, with the same numbering. There 
are also some graphs attached, to illustrate some of the effects. 


IS IT AUDIBLE? 

If you wish to delve into sounds much, you will need to be able to get 
a respectable volume from the speaker. First, there is a screw near 
the speaker plug inside your Beeb which can be turned up or down to 
alter the volume. If this is insufficient, refer to p.7 of the 
February issue for details on rewiring the Beeb to fit an extension 
speaker or employ one in your monitor if there is one. 


All envelopes here are accompanied by the same sound to demonstrate 


them: 
SOUNDI,N,50,26 ie a pitch (P%) of 50 and a duration (D%) of 2@ or 
1 second. 


The first parameter, ‘N’, is the number of the envelope. This number 
js the one used in the SOUND statement’s second parameter. You can 
define up to 16 envelopes in a program, providing you are not using 
the RS423 port. If however, you are using the serial port in the same 
programme, you are limited to 4 envelopes at a time (N={to4). Any 
other envelopes desired must redefine (overwrite) these 4 numbers. 


The second parameter, ‘T’, is treated later and briefly, with the 
promise of more about it next month. 


The following 6 parameters affect the pitch of a note, and as 
suggested by the setting out, there is a relationship between the PI 
and PN of the same number: mr 

PI4 : 


PI2 PN2 
P13 PN3 
4) If all are zeroes, there is no variation in pitch as a note is 


played: 
ENV.4 11325850 108,90 ,36,-4,0,-5 120,80 


1 


18 ENVELOPE! ,129,8,8,8,0,8,8,38,-4,8,-5,128, 80 
26 ENVELOPE2,132,4,6,0,12,040 »3¢,-4,8,-5,128 ,88 

38 ENVELOPES, 132,4,-4,8,12,12,9,28,-4,8,-5, 128,80 

48 ENVELOPE4,132,4,-4,8,12,12, 12,38 ,-4,6,-9, 128,88 
58 ENVELOPES,132,8,-8,0,1,1,12,38,-4,0,-5, 120,08 

68 ENVELOPES 50,16 ,-16,-16,6,3,3127,8 8,3, 124,124 
78 ENVELOPE? ,178,16,-16,-16,4,3,3,12740,8,-5, 126,126 
8 ENVELOPES, 129,14,-16,-16,6,3,3,127)6,8,-5, 126,126 
9G ENVELOPES, 1,16 )-16,-16,6,3,35127 48 )8,-5, 126,126 
188 ENVELOPE!€,J,8,~16,-16,8.3,3,127,8,8,-5,126,126 
118 ENVELOPE!1,1,4,8,6,1,6,8,126,-64,-64,-64,126, 126 


128 

136 FOR I4=1T01) 

148 PRINT’*Envelope # "31% 
{56 REPEAT 

168 SOUND! 1% 56,28 

178 UNTIL FNtest 

188 = NEXT IZ 

198 T4ei! 

288 PRINT’"Envelope # "3]4;" Popcorn tune '" 
218 PROCpopcorn 

228 END 


238 
248 DEF FNtest 
258 REPEAT 
268 = PRINT"Next envelope: Y/N? *; 
27f AXIS, I 
208 = REGETS 
298 PRINTR 
a RS=CHRS(ASC(RS AND &DF) 
UNTIL RE="Y" OR RE="N* 
204 IF R$="¥* THEN =TRUE ELSE =FALSE 


338 

34@ DEF PROCpopcorn 

358 RESTORE 

368 REPEAT 

378 = READ PA, 0 

300 F PAC=1 “Sout, TA PA, D482 

398 UNTIL Paz-i 

408 ENDPROC 

418 DATA 88,2,88,2,88,2,68,2,52,1,68,3,48,4,88,2,80,2,88,2,68,2,52,1,68,3,48,4 
ae ae 12 88,2,96,2,88,2,96,2,88,2,88,2,88,2,68,1,80,3,98,4,-1 
} 


is 


2) PIis4, PNi=i2 gives you a row of 12 notes, increasing in pitch by 
four. As the SOUND statement explains, an increase in the value of 
pitch of 4 means an increase of a semitone on the previous value. So 
this envelope describes an ascending chromatic scale with the use of 
only one sound statement: 

ENV.2:13214,0,0,12,6,8,39,-4,0,-5 120,86 


3)PI2=-4, PN2=12 adds a descending chromatic scale to the above, by 
virtue of a negative step in the Pitch Increment. The number of 
steps, 12, ensures that the mote finishes on the same pitch as it 
started: 

BN V.3,432 14 )-4,0412)12,0,30,-4,0,-5,120,86 


4) ee PN3=2 allows the sound to hold the pitch reached at the end 
of PIi2: 

ENV .45132)4,-4,0,12,12,12,36,-4,0,-5,426,80 

(This is more relevant when T<128) 


These parameters can be added together, split, amd combined in 
different ways. So ENV.3 could have also been written using all 3 
sets of parameters: 


Pli= 4 PNi=12 or: Pli= 4 PNI= 6 
Pl2=-4 PNZz= 6 Pr2= 4 PN2= 6 
PI3=-4 PN3= 6 PI3=-4 = PN3=12 


5) An envelope with a quick ‘hiccup’ at the beginning can be used to 
imitate a grace note: 

ENV,.5 13258 ,-8,054.1,12,30,-4,8,-5,120,80 

By varying these pitch changes, trills, turns and a variety of musical 
decorations can be eftected, 


There is one caution when mixing such envelopes in harmony - the 
overall pitch of a note is generally the pitch reached at the end of 
PI3 - which may not always be the one defined in the SOUND statement, 
which is where PIi starts from. 


By mow, you may be wondering why T is such a large number, when you 
may usually have met it with a value of ‘i’, and the User guide gives 
an acceptable range of @ to 127. ‘T’ is the length of time to be used 
by a step of PN within the envelope; counted in hundredths of a 
second, 

The Users Guide then refers to bit 7? being on or off. It is set on by 
adding 128 to the chosen value of ’T’. So above, where T=132, in fact 
T=4 without auto-repeat. So T=132 is not allowing 1.32 seconds for 
each semitone in the above envelopes, but only .64 of a second. 


The next four envelopes show the effect of altering this parameter 


LS 


only. 

Number 6 allows the PIs to cycle round slowly at the rate of half a 
second per step; number 7 stops the cycling round and only allows each 
step to sound once: 

6) EEN V6 956) 1697 165-16 5659595127 50.8;-0 126,126 

7) ENV.70177 16974657 4696 93995127 50585-95126 ,126 

You may have noticed the variation in volume as the steps occur at 
different stages of the amplitude section too. This is an effect of 
the ‘decay’ part of the envelope. The sound produced seems much 
longer than the i second (D%=20) allowed in the SOUND statement, but 
when there is another note following the sound, the first will be cut 
short during the decay phase so it only sounds for the length 
specified by Dh. 


The only change to the next two envelopes is to set T to the minimum - 
number & is the same as 7 except that the time allowed for each step 
has been set to the minimum. 

SEN V8 51285155746 5-166 19194127 858,79 426,126 

DYN V9 1444657169716 65309012798 8,54 265126 

Number ? is also set to the minimum, but allows the envelope to cycle 
round (auto-repeat) - siren~like wails can be made by this rapid 
cycling through steps at a far faster rate than allowed solely by 
SOUND statements. The notes making up this ‘noise’ come too quickly 
to be discerned individually. 


10) A ‘feature’ of the Beeb is that when the value given for pitch is 
outside the range @ to 255, it ‘wraps around’, i.e. pitch=2é6¢ in fact 
sounds like pitch=5. The envelope below is likely to demonstrate this 
effect when the pitch reached is outside this normal range, 

EON V4 64 909-46 5-1.658,3)9512750:05-5 426,426 

The sound starts at a pitch of 5@ (set by SOUND), then drops by 16 
(PI2Z&3) 6 times (PN2+PN3). 58-(16#6)=-46 OR 207! 


11) The Last Envelope: 
EN V.14447410100416,0,126,-64,-564,-64,126,126 
has its own tune too. 


The Program: 
This program can be used from immediate mode too. The envelope number 


used for the tune is variable, so by entering I%= (itoil) then 
PROCpopeorn you can hear the tune in any envelope you wish, Bet 
you've already thought of defining a function Key to call the PROC 
too! 


Alternatively, to hear it through the range of envelopes defined: 
FOR 1%=1T014:PROCpopcorn:NEXT 1% 


You will also find that the effect of an envelope on a series of notes 
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{tune} makes them sound rather different fram the sound you heard with 
a single note. This is an effect of the second half ot the ENV. 


THE GRAPHS: — 

These are from graphs produced using the Envelope Editor from the 
Nov.‘82 issue of Beebug. Printed out after each one are the current 
values of the relevant parameters. 


The horizontal axis represents time in 1@@ths of a second. Time is 
set to zero at the extreme left, The next number is the length of 
time taken to reach the end of PNi. Referring to graph 3 (ENV.4): 

The number 48 represents 48/160ths of a second, made up of 12 steps as 
specified by PNi, multiplied by the value of T (actuaily T MOD 12%). 

The next mumber (94) is the time elapsed from the beginning, to the 
end of PN2; the third (144) is total time to reach the end of PN3: 


TxPNI 4x12 =49 
CTxPNI) +(TxPN2) 64x12)404x12) =96 
6TxXPN1) 40 TxPN2) +<TxPN3) 4x12)4¢4x12)4+(4x12)=144 


The vertical axis represents pitch. Pitch is initially set by P% in 
the SOUND statement - here P%=56. The envelope’s influence is then 


shown: 
The effect of PI1 & PN{ are to raise P% from 58 to 98 via 12 steps of 
4: 


CP%+(PIixPNi)] 
Then Pl2 & PN2 make their effect: 
PN2=12; PI2=-4 so there are {2 steps; each decreasing the pitch 
reached at the end of PNi, by 4. This reduced the pitch to 52, 
whereupon PI3 & PN3 take up the chance. 
Here PI3=@ and PN3=1Z. This means that the pitch changes by @ for {2 
units of T. tie not at all’). 


POST SCRIPT: 

Don't expect to make much sense of this at first reading, it does 
require dream time to sort out! Plotting your own graphs on paper can 
help sort out the relationships too. I am aware that I have been 
rather concise ~ not wanting to take up the whole of the mag for a 
month ~ so if you think you would like some of this expanded further, 
write in and ask) and I/il try te do so. Don’t ask for an explanation 
of the rest of the envelope though - I’m still trying to figure out 
now that all fits together, 


And for the 11th month ENV.1! graph HAD to appear on the cover !! 


SEESPPPEPEPEPSE SESE ESE PES 


ai 
PROBLEM PAGE: 


Some members have suggested we have one. Here itis. What is your 
problem? Must confess, the Editor expects people are too impatient to 
wait a month or two for an answer to their oroblem to appear in these 
pages; out of course ... not everyone writes im with their problem! 
Ferhaps if it appeared here, AND if it got read, others would solve 
the same problem that bugs you. 


The assumption: that someone reads the problem page and is moved tc 
write in with the solution for it/them. 


DEBUGGING 

Do we offer a debugging service? Since this is usually asked py 
people Keying in listinas from other magazines, either there is a 
clerical error that they have made, cr corrections are published im é 
subsequent issue of the magazine the listing came from. If suth 2 
program comes to the committee, if tends to take an age te find, 
simoly because the mugginses on it are already very busy. 


MODen BUG? 


Anton and ‘Battleship Stephen’ 
A program bug was discovered to be caused by tne MOD function. Those 
unfortunate enough to have been taught MOD maths will Know that there 
15 no negative result from the mod operation, Time in hours ( MCD 12: 
is never minus 2 o’clock. But! The Beeb does have and allow negative 
results: 


The Users Guide defines MOD in terms of DIV. It re¢ers you to MOL 
when er look up DIV. But MOD is all about circular maths ... (snari, 
snarly.., 


So,.. by writing A% MOD BY 

you have the same effect as writing: 

SGNIA®)#ABS(AR) MOD ABS(B%) 

In other words, the sign of A% matters, but not that of BX, 


oe oe Fees we tir fini reve ELE we ae ni 
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25 








Ey - S 
58 
56 a 
T PI1 PI2 PI3 PHS PR? PN3 

a 
146 
58 
a 

J PIL P12 PY3 PRE PH2 PHI 

HB 16-36-18 6 3 3 
4 ovens 
8 





1 PIL Pi2 FI3 PRE PH2 PH3 
1 6 «-f6 -l6 & F 3 


Wow ! EWM 
PRIME PLINGIES ! ! ! ! 


Anton E. Watn 
The prime number program given here cheats. The prime challenge (May 
issue) specifically disallows plings and queries, but I have found 
these to be the simplest, fastest and clearest way of solving the 
problem. The objection that indirection operaters do not permt a 
reader ta easily understand a program is usually quite valid, but here 
they simply allow the creation and marking of a very long line of 
‘cards’ each representing an odd number. That’s not abtuse at all. 
Any odd number (N%) can be found at address S%+(N%-1)/2. Points of 
note: 
{, The method uses the sieve of Erastosthenes - See previous 
issues of the newsletter. Only one byte array is created and the 
lower bytes check the higher ones, 
2. The array of bytes 15 not automatically zeroed; this is done 
at line 108. Contrast this with arrays of integers or reals, 
3. As an alternative method, instead of zeroing, which 15 rather 
wasteful, use can be made of a repeating pattern every 15 bytes 
caused oy divisibility sy 3 or 35, Thus initialization 
simultaneously marks those most frequently marked off, and zeroes 
the rest. This method reduces the time taken down te 17.4 
seconds. iNote the use of plings !!}) 
Why bother? I extended the above method to check all primes to 100 
million. It taok 42 hours ~ without printing them. This enabled me 
+9 cneck a predicator P(X) of the number of primes under some value 4, 
“he predictor was faulty and the new, improved oredictor 25: 
P(X} = (1 +4. 6/65 34+K#K) 4X/(K-1) 
“mere KELNQ®, I think it will take machine code to better that 
predictor, 
fon the method referred to in 13) above, replace jinmes 106-118 with 
*he tallowing: 


188 FOR MSZ TO SHINY STEP 15 
(82 Mut 810831! 4=a 100008! 
fd M18 W188 80 ML! {2k 


#6 NEXT 
168 = | S4=8 
1B 
A MISTAKE: 


Last month, under Musical Medley. (with apologies te Ian Birnbaum), the 


varaable’s name changed. The listi i : 1 
notboth. Ke g isting should have either 1%’s or M%‘s, 
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18 MODE? 

28 DIM 54 246888 

36 REPEAT 

44 REPEAT 

34 INPUT"Upper limit of orimes * NA 
68 UNTIL NZ}8 AND N4( 48881 

7 TIMES6 

fe = =&505 

96 NAS(NZ-1)D1V2 

166 ee TO SS#+NA: M48 NEXT 


128 REPEAT 
138 REPEAT :RASRA+b UNTIL SYZ2R4=8 
148 TA Q4RAH RAG LF 


158 PS DaRY! 
16 FOR Ma=SZATH TO SuANA STEP Px 
178 MSL INEXT 


1a UNTIL TAN: 

19E -PRINT2: 

266 0 FOR Mé=Su4+1 TD SZaNY 

218 TF M426 THEN PRINT2#(M/-SiH)41 
226 NEXT 

236 | @4=160:PRINT:PRINTTIME/186:"° SECS" 
24@ = UNTIE FALSE 


MAILeAG 


DAVID, Greenhithe: 

4, I've just finished a program in old-style BASIC) that = stores. 
retrieves and analyses 72x3 item data using disc. I’ll shortiy be 
adding correction facilities, using the random access instructions, 
but in Mode @ (8@ cols + underlining) I’m almost out of memory. Does 
anyone Know of an existing inventory or income and expenses program 
that would let me analyse and print out up to 1@ types of expense? 

2. What is 145¢ at the end of my address label? 


{. Have a look at BBCsoft’s ‘Record Keeper’, £55.06. It will allow 4 
data files PER disc, about &@ records, with 9 fields, each of 26 
characters in length. The program can be altered to alter these. 

as zip code - wat the PO wants in exchange for cheaper postage 
rates, 

3. David also offers a thumbnail sketch of the editor, with the 
suggestion of athers sending in for publication, as well, No thanks - 
I’ve already had Sam (a Sam-ess actually, in Birkenhead) telling me | 
should have a black tooth. ‘Well, greyish sort of. Discoloured’ she 
offers. I don’t think my ego could carry the burden! 
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Brian M. Tokoroa: 

Recently I was asked to put my BEEB where my mouth was: I am nota 
braggart, but when the opportunity arises I will extoll the virtues of 
the BEEB. So 1 was given this little Bench Mark test and told how 
well others had faired viz:~- 

CASIO hand-held 1 min ii secs 

SHARP hand-held 2 min 36 secs 


TANDY 2 min 36 secs 
APPLE Ile {2 secs 
CBMé64 11.5 secs 


Well, said I, I'l] halve that time {meaning of course, the Beeb 
would), and punched in the fallowing:~ 

1@ TIME=@ 

26 X2,5 

38 FOR Y=1 TO 109 

48 X=(PI4X)*5) -— ENTU(PE+X0*S) 

5@ NEXT Y 

6@ PRINT X 

70 PRINT TIME/1¢0 

80 END 
You can imagine my disappointment when up came the result: 20.8 secs. 
I immediately reran the program in disbelief that the Been had failed 
to live up to my expectations; Lo and Behold! back came the same 
answer! What a let-down, to have to say to my CBM64 friend ‘Your’s is 
better’. I could hear him now, as he quietly let the world Know, 
AT LAST MY 64 HAS DONE SOMETHING Eaaee THAN THE BEEB 

YAAHOO!!! 
But, this can’t be so, thought I, and looked to see what the Beeb had 
done wrong. It is always mistyping or misspelling. Twice, thrice, ! 
searched in vain; each time ignoring ‘the obvious error. Then I 
Saved The Day '! The silly machine had entered 
30 FOR Y=1 TO 10@@ instead of 1 TO 14@. 
Face saved; and even better than I had said - the Beeb didn’t Just 
haive the time, but Knocked it back to less than a fifth at 2.08 secs. 
Not bad considering it can’t even type or spell! 


Ed: REM digital calculater Known since before mankind: fingers! 
Rather more error-prone as suggested here. Makes a change from the 
Apole-bashing tales usually told too. 


SOFTWARE LIBRARY: 

Athol K. in Wgtn is, interested in, setting up a ‘swap’ library of 

magazine programs - along the lines of you sending a listing in 

(debugged) that you've typed in, and swap it for another. There would 

el ese charge for this too. 35c stamps dan’t come cheap'! Nor do 
S 
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SOFTWARE 


forthe BBC model B microcomputer. 



















ELECTRONICS DESIGN PACKAGE NO. 1 





SUITABLE FOR THE ELECTRONICS HOBBYIST, 
TECHNICIAN OR ENGINEER 


All parts of this Program are accessible. 
This package will aid in the design of: 


Resistor combinations to give specified 
values. 







Potential dividers. 





Values of resistors for power supplies 
based on the National Semiconductor 
series of 3 terminal adjustable voltage 
regulator integrated circuits. 









4. Inverting and non-inverting amplifier 
feedback resistor values. 


In each of the above cases where appropriate 
you have the option of displaying simple 
resistor combinations using E12 standard 
values that give the closest value to that 
required, 







Supplied on cassette, 1200 Baud. 


To purchase, send $20 with order to: 















IDEX INTERNATIONAL LTD 
P.O.BOX 6070 HAMILTON 
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USER GROUP HEETINGS 

AUCKLAND:-meets 2nd Wednesday of the month, 8.@@pm, VHF clubrooms, 
AL Ca Mt Rostill. ph. Dave 776-638 » 3iflbus) or Kerry 
695—~ 

HAMILTON:-last Wednesday of the month Spm Waikato Tech B block 
staffroom, Ph. Peter, Hamilton 393-998 or Alison, 
Morrinsville 6695. 

HAWKES BAY:-Alternate months Hastings & Napier. Contact Kerdall 
Napier 435~624, Bob Taradale 446-955, Mitch Hastings 
778-235. 

TAUFO:-Contact David $4-215. 

WELLINGTON:~meets LAST Thursday of the month, 7.3@pm; Correspondence 
School Staffroom (ist floor), Portland Cres, Tharndon. ph. 
Anten 284-289 or Warren 787-065, 

CHRISTCHURCH:-fortnightly workshops, Tuesdays 7.00pm at Hagley High 
School. ph. Michael 582-267, 

OTHER CENTRES:- let us Know to publish details here. 


CLASSIFIEDS & DEALS: 
Cassette leads to allow motor control (ie 7-pin DIN to 3 Jacks): $5.00 
plus 5@c p&p. ph. Kevin Wgtn 849-243 or write c/- Box 9592 Watn. 
TAPES: C-105, boxed, leaderless - available fram the User group in 
multiples of 2@ $24.98 plus $2.00 p&p. 


THE NEWSLETTER: 

CONTRIBUTIONS:- most welcome. Listings should be sent inon tape cr 
disc. (Tape - 2 copies, one at 360 baud please) A 35c stamp 
gets your tape / disc returned too. Please include written 
explanation of listing; text-only material welcome tea, 

DEADLINES:- For a particular issue, the last day for material is the 
last day of the month prior to the month of publication, 

ADVERTISING:- Rates are $2@ per half page, deadline as above. 


Copyright {c) THE BBC MICROCOMPUTER USERS GROUP OF NZ INC, 
Published monthly and mailed to financial members, 


MEMBERSHIP: 
Membership of the users group is on payment of an annual subscription from April 
to March, For the 1983/4 year it is: $28.08, plus a $5.08 joining fee for new 
members, plus $5.06 for Auckland & Wellington members as a local Branch levy, 
which entitles attendance at meetings as detailed above, Renewing members get 
all back issues of the current year; New members get ALL back jssues back to y./ 
4) dan ‘83. 


THE BBC MICROCOMPUTER USERS GROUP OF NZ IHE 
P.0.Box 9592 
Wellingten 
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